7 MyID Operator Client error codes

This section contains the list of server-generated errors that may occur when using the MyID Operator Client, the MyID Core API, or the web.oauth2 and web.oauth2.ext authentication services.

To assist with the diagnosis of issues, Intercede support may guide you to enable logging on the rest.core or web.oauth2 web services; you can then provide these logs to customer support for analysis. See the MyID REST and authentication web services section in the Configuring Logging guide for details of enabling logging.

Note: You may also see errors produced by the MyID Client Service when using the MyID Operator Client. See section 8, MyID Client Service error codes for details.

Error Code

OA10001

Text

Unable to communicate with app - ensure that MyID UMC app (MyIdClientService) is running

Details

The web page has been unable to communicate with the MyID Client Service.

Solution

Make sure the MyID Client Service is installed and running.

See the Installing the MyID Client Service section in the Installation and Configuration Guide.

Make sure that the browser you are using supports websockets connections to ws://localhost. See the Supported browsers section in the MyID Operator Client guide.

 

Error Code

OA10002

Text

Invalid credentials

Details

The credentials you have supplied for authentication are not valid.

Solution

Supply valid credentials for logon.

 

Error Code

OA10003

Text

You do not have sufficient security questions configured

Details

The person attempting to log on must have sufficient security questions set up on their account. The number of required security phrases is specified by the Number of security questions for self-service authentication configuration option.

Solution

Use the Change Security Phrases or Change My Security Phrases workflows to provide the required security phrases. See the Setting security phrases section in the Operator's Guide.

Alternatively, you can set a lower value for the Number of security questions for self-service authentication option. See the Setting the number of security phrases required to authenticate section in the Administration Guide.

 

Error Code

OA10004

Text

Your username or security response is incorrect, or you may not have permission to access this client.

Details

The person attempting to log on has mistyped their username or security responses.

Solution

Try again.

Note: If the number of failed attempts exceeds the configuring maximum (by default, three) the person may be locked out and will have to have their security phrases unlocked. See the Configuring the number of attempts to enter security phrases section in the Administration Guide.

 

Error Code

OA10005

Text

The registration link is invalid

Details

The registration job ID is not a valid job ID.

This can also occur if there is a problem with the request that is being collected, or the request is not at the ‘Awaiting Issue’ status; for example, if it has been canceled.

Solution

Carry out the request again.

 

Error Code

OA10006

Text

Logoncode OTPs are disabled on the server

Details

The Allow Logon Codes option is not set on the server, or the person's role does not have access to the Password logon mechanism.

Solution

Set the Allow Logon Codes option, make sure the person has access to the Password logon mechanism, then try again.

See the Setting the configuration options and the Configuring roles for registering FIDO authenticators sections in the FIDO Authenticator Integration Guide for details.

 

Error Code

OA10007

Text

Your OTP has been entered incorrectly, is locked, has expired, or you do not have permission to perform this operation. Please try again.

Details

The registration code was incorrect, or has been entered incorrectly too many times, or you do not have access to the Register FIDO Security Key operation.

Solution

Retry entering the registration code. If it continues to fail, it may be locked. Request another FIDO authenticator.

Check that your have access to the Register FIDO Security Key operation; see the Configuring roles for registering FIDO authenticators section in the FIDO Authenticator Integration Guide for details.

 

Error Code

OA10008

Text

Your session has timed out or is invalid, please try again

Details

You may have waited too long to complete the registration process.

Solution

Try again.

If you have already used your registration code, you must request the FIDO authenticator again, which will send you a new registration code.

 

Error Code

OA10009

Text

Error registering FIDO in browser

Details

The ServerDomain app setting may configured incorrectly. Note that ServerDomain is case sensitive and must be consistent with the casing of the DNS Name in the web server's TLS certificate.

Solution

Set the ServerDomain in the app settings file.

See the Adding the access token to the web service configuration file section in the FIDO Authenticator Integration Guide for details.

 

Error Code

OA10010

Text

Error authenticating FIDO in browser.

Details

A cause of this is if the FIDO credential was registered on a website running a different origin to the website that is performing the authentication – at registration, FIDO credentials become locked to the origin on which they were registered.

This may also occur if the web.oauth2 Fido:Config:Origin is configured incorrectly in the authentication service app settings file. Note that Origin is case sensitive and must be consistent with the casing of the DNS Name in the web server's TLS certificate

Solution

Set the Origin in the app settings file.

See the Adding the access token to the web service configuration file section in the FIDO Authenticator Integration Guide for details.

 

Error Code

OA10011

Text

FIDO authentication failed, please try again. You may not have permission to access this client.

Details

This may occur when the credential profile for a FIDO authenticator was set up to require user verification, but the FIDO authenticator does not support that feature.

This may also occur when you are attempting to log on with a FIDO authenticator without providing a username, but the credential profile was not set up with the Require Client Side Discoverable Key option, and consequently the FIDO authenticator does not have the key required for logon without a username.

Solution

Try a different FIDO authenticator, try a credential profile that has been set up with less stringent requirements, or try a credential profile that sets up the client side discoverable key; see the Setting up credential profiles for FIDO authenticators section in the FIDO Authenticator Integration Guide for details.

 

Error Code

OA10012

Text

FIDO registration failed, the FIDO token used to register was not trusted. Try a different FIDO token if you have one. <details>

Details

The FIDO authenticator you have tried to register failed the attestation check.

Solution

Try a different FIDO authenticator.

 

Error Code

OA10013

Text

FIDO registration failed, user mismatch

Details

The FIDO authenticator cannot be registered as there is a problem matching the user.

Solution

Try registering the authenticator to a different user.

 

Error Code

OA10014

Text

FIDO registration failed, the credential profile is invalid

Details

The credential profile is not valid, or the person for whom the FIDO authenticator was requested has changed roles, and can no longer receive the originally-requested credential profile.

Solution

Request a FIDO authenticator using a different credential profile, and try again.

 

Error Code

OA10015

Text

FIDO registration failed, this token is already registered

Details

The FIDO authenticator is already registered.

Solution

Try a different FIDO authenticator.

 

Error Code

OA10016

Text

FIDO registration failed, the credential profile is set to Enforce Authenticator Attestation Check, but the token registered does not have metadata available on the server. Try registering a different token.

Details

The manufacturer did not register metadata with the FIDO metadata service, and the file-based metadata does not include information about this token. This token cannot be used with this credential profile.

Solution

Either register a different token, register this token to a different credential profile using a credential profile that does not have Enforce Authenticator Attestation Check set, get the token manufacturer to publish the metadata for this token to the FIDO metadata service, or obtain the FIDO metadata and configure it manually on the server using the MDSCacheDirPath setting.

See the Setting up credential profiles for FIDO authenticators or Setting up a local metadata repository section in the FIDO Authenticator Integration Guide for details.

 

Error Code

OA10017

Text

FIDO registration failed, there was a problem accessing the FIDO Metadata Server

Details

There was a problem trying to get a metadata TOC payload entry from the FIDO metadata service.

Solution

Check that the URLs https://*.fidoalliance.org are accessible from the web server and try again.

 

Error Code

OA10018

Text

You do not have any FIDO tokens registered

Details

The person has attempted to authenticate to the MyID authentication service using FIDO, but does not have any registered FIDO authenticators.

Solution

Request a FIDO authenticator for the person.

 

Error Code

OA10019

Text

Username should not be null or empty

Details

The MyID Username claim was missing in the cookie for the call to logon with FIDO.

Solution

Restart the browser and try again.

 

Error Code

OA10020

Text

Invalid return URL

Details

The return link from a logon authentication call was invalid.

Solution

This may be the result of a redirect attack or a malicious link. Make sure you have gone through the correct procedure.

 

Error Code

OA10030

Text

MyID:Database:ConnectionStringCore is not configured

Details

A configuration file error has occurred. You must configure a database connection string.

Solution

Check the configuration file settings – ConnectionStringCore must be configured.

See the Configuring the standalone authentication service section in the MyID Authentication Guide.

 

Error Code

OA10031

Text

MyID:Database:ConnectionStringAuth is not configured

Details

A configuration file error has occurred. You must configure a database connection string.

Solution

Check the configuration file settings – ConnectionStringAuth must be configured.

See the Configuring the standalone authentication service section in the MyID Authentication Guide

 

Error Code

OA10032

Text

Unable to find configured JWT signing certificate

Details

No JWT signing certificate was found, but JWT signing is configured.

Solution

Check the JWT settings. See the Load balancing section in the MyID Operator Client guide.

 

Error Code

OA10033

Text

No JWT signing certificate configured and no RSA signing key containername configured

Details

MyID is configured to use a previously configured RSA keyname but no RSA container name was found.

Solution

Check the JWT settings. See the Load balancing section in the MyID Operator Client guide.

 

Error Code

OA10034

Text

JWT signing key is configured, but has an incorrect algorithm or key size

Details

MyID has found an RSA key with an incorrect algorithm or key size.

Solution

Check the JWT settings. See the Load balancing section in the MyID Operator Client guide.

 

Error Code

OA10035

Text

Generated JWT signer certificate, but unable to load it

Details

A server error has occured while attempting to validate the generated signer certificate.

Solution

Check the JWT settings. See the Load balancing section in the MyID Operator Client guide.

 

Error Code

OA10036

Text

No JWT signing certificate configured and no RSA signing key containername configured, and not configured to generate a JWT signing key

Details

A configuration error has occurred. No authentication method has been set.

Solution

Check the JWT settings. See the Load balancing section in the MyID Operator Client guide.

 

Error Code

OA10037

Text

You do not have permission to perform this operation. Your permissions could not be verified

Details

A valid access token has not been supplied to authorize this extension grant. The token may be missing, may not contain the required claims.

Solution

Check that your system is providing the correct data for the extension grant.

 

Error Code

OA10038

Text

You do not have permission to perform this operation

Details

This can happen if the caller does not have scope over the object (request, device or person) in the context of the operation being performed.

Solution

Check the roles that the person has and check the permissions these roles give in Edit Roles.

 

Error Code

OA10039

Text

You do not have permission to perform this operation on the identified object or the identified object does not exist

Details

This can happen if the caller does not have scope over the object (request, device or person) in the context of the operation being performed.

Solution

Check the roles that the person has and check the permissions these roles give in Edit Roles.

 

Error Code

OA10040

Text

Your assigned roles do not have permission to collect this request’s credential profile

Details

The credential profile does not include any of your roles in the Can Collect option.

Solution

Edit the credential profile to add one of your roles to the Can Collect options for the profile.

 

Error Code

OA10041

Text

Authorization failure, missing data

Details

Data required to perform the extension grant is missing. This should not be seen through the MyID Operator Client but may occur if integrating third party systems to perform token operation extension grants if they do not supply the required data.

Solution

Check that your system is providing the data required to perform the extension grant.

 

Error Code

OA10042

Text

This item is not in the correct state to perform this operation

Details

You have attempted to carry out an operation that requires a particular status; for example, collecting a card requires a job status of Awaiting Issue. If this error occurs, the status is no longer correct for the operation; this may occur when multiple operators attempt to carry out an operation on the same item.

Solution

Go back and attempt the operation again from the beginning; if the item is not in the correct status, you should not be offered the opportunity to carry out the operation.

 

Error Code

OA10043

Text

Your assigned roles do not have permission to unlock this device

Details

When the configuration flag Constrain Credential Profile Unlock Operator is set, when unlocking devices for other users you require the Can Unlock permission for the credential profile of that device.

Solution

Edit the credential profile to add one of your roles to the Can Unlock options for the profile.

 

Error Code

OA10044

Text

You cannot perform this operation on yourself

Details

You have attempted to perform and operation that is not allowed for self-service on your own account.

Solution

Either perform the operation on another person's account, or get another operator to perform the operation on your account.

 

Error Code

OA10045

Text

You cannot perform this operation on others

Details

You have attempted to perform an operation that is allowed for self-service only on another person.

Solution

Either perform the operation on your own account, or get the other person to perform the operation on their own account.

 

Error Code

OC10001

Text

There are no actions available for your current logon method and the roles that you have been assigned.

Details

You have not been assigned any actions for use in the MyID Operator Client.

Solution

Ensure that the roles you have assigned provide MyID Operator Client actions.

See the Roles and groups section in the MyID Operator Client guide.

 

Error Code

OC10002

Text

This web browser cannot be used. Please use an alternative web browser.

Details

An unsupported browser has been detected. Due to the browser technology used, you cannot use Internet Explorer to access the MyID Operator Client.

Solution

The MyID Operator Client is designed to work on a range of browsers running on Windows 10, excluding Internet Explorer. You are recommended to use Google Chrome, Microsoft Edge (Chromium version) or Mozilla Firefox.

See the Supported browsers section in the MyID Operator Client guide.

 

Error Code

OC10003

Text

There has been a problem on server and it is not possible to continue.

Details

The API server is unreachable or has been configured incorrectly.

Solution

Confirm that the API server is reachable, and has been configured correctly.

Check the URLs in the web service configuration files; they must use https and be valid URLs. See The rest.core web service configuration file and The web.oauth2 web service configuration file sections in the MyID Operator Client guide for details of the web service configuration files.

The REST-based web services require HTTPS, and will not operate if this is not set up. For more information, see the REST-based web services section in the System Interrogation Utility guide.

 

Error Code

OC10004

Text

The server could not be contacted. Please try again.

Details

Connection to the server unavailable. Either the client is not connected to the Internet, or the server is offline.

Solution

Confirm that the API server is reachable, and try again.

Confirm that you have the correct server address specified; see the Specifying the server for the MyID Client Service section in the MyID Operator Client guide.

 

Error Code

OC10005

Text

The file you have uploaded is not an image. Please upload an image.

Details

You can choose from the following file types:

  • JPEG (*.jpg, *.jpeg)

  • Bitmap (*.bmp)

  • Graphics Interchange Format (*.gif)

  • Portable Network Graphics (*.png)

If you select a file of the wrong type, MyID displays an error.

Solution

See the Uploading an existing image file section in the MyID Operator Client guide.

 

Error Code

OC10006

Text

MyID Client Service error

Details

You have attempted to use a feature provided by the MyID Client Service App (for example, editing a captured image), but the app is not running.

Solution

See the Installing the MyID Client Service section in the Installation and Configuration Guide for instructions on installing the MyID Client Service.

 

Error Code

OC10007

Text

A problem has occurred when connecting to the camera.

Details

The MyID Image Capture component cannot make a connection to the camera.

The camera might be in use or has a low maximum supported camera resolution.

Solution

Confirm that the camera is operating correctly and can support a minimum resolution of 640x480.

Confirm that the camera is not currently in use in another application, then start Image Capture again.

 

Error Code

OC10008

Text

Unable to launch the Desktop Application. Please check configuration and try again.

Details

MyID Desktop or the Self-Service App could not be found at the configured path.

Solution

Confirm that the application is installed and available at the configured location.

See the MyID Operator Client advanced configuration section in the MyID Operator Client guide.

 

Error Code

OC10009

Text

Unable to connect to the Desktop Application. Please try again.

Details

MyID Desktop or the Self-Service App was unable to be started, or is already running, and the MyID Client Service failed to connect to it.

Solution

Confirm that MyID Desktop is run in service mode and try again.

 

Error Code

OC10010

Text

Unable to launch the Desktop Application. Please try again.

Details

MyID Desktop or the Self-Service App is running but is already servicing a request.

Solution

Try again when the current request has been completed.

 

Error Code

OC10011

Text

The item is not available. Check the link is valid and you have permission to access this information.

Details

The operation or entity provided in the URL link is not available. Confirm that the link provided is valid and you have permissions for the operation specified.

Solution

Confirm that you have permissions to the link provided and try again.

 

Error Code

OC10012

Text

The item is not available. Check the link is valid and you have permission to access this information.

Details

The search provided in the URL link is not available. Confirm that the link provided is valid and you have permissions for the search specified.

Solution

Confirm that you have permissions to the link provided and try again.

 

Error Code

OC10013

Text

Unable to launch the Desktop Application. Please try again.

Details

An incorrect version of MyID Desktop has been detected.

Solution

Confirm that the correct version of MyID Desktop is installed, and try again. You may have to upgrade your version of MyID Desktop to the latest version to support the feature you are trying to use.

 

Error Code

WS10000

Text

Server error

Details

An internal server error has occurred.

Solution

Retry the operation; the cause could be a temporary issue such as a database timeout due to server load.

This error may also occur if you have configured your system to use the web server to store images and have attempted to upload an image using the MyID Operator Client; this is not a supported configuration; see the Displaying images stored on the web server section in the MyID Operator Client guide for details.

If the problem persists, check the System Events and Audit Reporting workflows within MyID, then the rest.core logs for more information. For information on configuring logging, see the MyID REST and authentication web services section in the Configuring Logging guide.

 

Error Code

WS10001

Text

Unable to convert WSQ image to 378 biometric format

Details

The supplied WSQ image is either corrupt or invalid or the Aware components are not installed on the server.

Solution

Check that the WSQ image is valid.

Check that the Aware components are installed on the server.

See the Aware Fingerprint Capture guide provided with the Aware Fingerprint Capture module.

 

Error Code

WS10002

Text

Unable to retrieve the values for the specified selection box.

Details

A problem has occurred with a dynamic drop-down list, where the contents of one list depend on another; MyID was unable to call the stored procedure specified for the dependent list. This feature may have been implemented on a custom system using Project Designer.

Solution

Check that your linked picklists are configured correctly in Project Designer; if your custom system was provided by Intercede, contact customer support, quoting the error reference WS10002.

 

Error Code

WS10003

Text

Unable to retrieve the requested session information.

Details

There is an API method that allows you to retrieve information about the currently authenticated session. This error appears when there is a problem determining the session.

Solution

Re-authenticate and try again.

 

Error Code

WS20000

Text

Server configuration error

Details

There is a problem with the server configuration.

Solution

Check the System Events, Audit Reporting workflows within MyID, then the rest.core logs for more information. For information on configuring logging, see the MyID REST and authentication web services section in the Configuring Logging guide.

 

Error Code

WS20001

Text

Server configuration error - DataDictionary is inconsistent

Details

The MyID Project Designer configuration is incorrect, preventing the server from starting correctly.

Solution

If you are using MyID Project Designer to develop your own custom configuration, use Project Designer to correct the configuration and reapply the project configuration.

Check the logs for information about the faulty data. For information on configuring logging, see the MyID REST and authentication web services section in the Configuring Logging guide.

 

Error Code

WS20002

Text

Server configuration error - SearchCriteria is inconsistent

Details

The definition of the search criteria is incorrect.

Solution

This requires a database fix.

You must contact customer support quoting reference SUP-327 and provide details of which search operation is experiencing this error.

You will also be asked to provide log files; for information on configuring logging, see the MyID REST and authentication web services section in the Configuring Logging guide.

 

Error Code

WS30000

Text

Minimum data not supplied

Details

There has been a problem with the processing of information entered on the form.

Solution

Check the data you have entered and try again.

 

Error Code

WS30001

Text

Invalid data supplied

Details

There has been a problem with the processing of information entered on the form.

Solution

Check the data you have entered and try again.

 

Error Code

WS30002

Text

Validation problem, the value for <field name>, <details>

Details

This error occurs when the <field name> field contains a value that is not allowed. This is a generic error; you are more likely to see a more specific error that gives a reason for the validation problem.

Solution

Check the values you have entered for the specified field and try again.

 

Error Code

WS30003

Text

Invalid person id specified

Details

The person you have specified does not exist; for example, the person may have been removed by another operator. Alternatively, you have specified a person over whom you do not have permission.

Solution

Check the data you have entered and try again.

 

Error Code

WS30004

Text

Validation problem, the value for <field name>, invalid role specified

Details

You have selected a role that is not allowed.

Solution

Check the roles you have selected and try again.

 

Error Code

WS30005

Text

Validation problem, the value for <field name>, must be no more than <number> characters

Details

The value you have entered for the specified field is too long.

Solution

Provide a shorter value for the field and try again.

 

Error Code

WS30006

Text

Validation problem, the value for <field name>, invalid value for search criteria

Details

The value you have entered for the specified field is not allowed as part of the search criteria.

Solution

Check the search criteria you have entered and try again.

 

Error Code

WS30007

Text

Validation problem, the value for <field name>, must contain a value

Details

You have not entered a value for the specified field.

Solution

Enter a value for the specified field and try again.

 

Error Code

WS30008

Text

Validation problem, the value for <field name>, is not a selectable value

Details

You have provided a value for the specified field that is not available in the drop-down list.

Solution

Check the value you have entered for the specified field and try again.

 

Error Code

WS30009

Text

Validation problem, the value for <field name>, <details>

Details

You have entered a value for the specified field that contains a value that is not allowed. The <details> provide more information about why this value was not allowed; for example, "must be a date in the past" or "must be alphanumeric".

Solution

Check the value you have entered for the specified field and try again.

 

Error Code

WS30010

Text

Validation problem, the value for <field name>, fails Validation rule <rule>

Details

You have entered a value for the specified field that contains a value that is not allowed. There is no description for this validation rule; it may be a custom validation rule.

Solution

Check the values you have entered for the specified field and try again.

 

Error Code

WS30011

Text

Validation problem, the value for <field name>, can only be 0 or 1

Details

You have entered a value for the specified field other than 0 or 1, and this field only allows those values.

Solution

Enter a value of 0 or 1 in the specified field and try again.

 

Error Code

WS30012

Text

Validation problem, the value for <field name>, must be a number

Details

You have entered a value for the specified field that is not a number.

Solution

Enter a number in the specified field and try again.

 

Error Code

WS30013

Text

Validation problem, the value for <field name>, must be a valid uuid

Details

A field has been supplied to the server that is not a valid UUID (universally unique identifier).

Solution

If you are using the MyID Operator Client, retry the operation. If the problem persists, contact customer support, quoting reference SUP-328.

You will be asked to provide log files; for information on configuring logging, see the MyID REST and authentication web services section in the Configuring Logging guide.

 

Error Code

WS30014

Text

Validation problem, the value for <field name>, must be a date or datetime

Details

You have entered a value for the specified field that is not a valid date or time and date value.

Solution

Check the value you have entered and try again.

 

Error Code

WS30015

Text

Validation problem, the value for <field name>, is mandatory

Details

You have not entered a value for the specified field; this field is mandatory.

Solution

Enter a value for the specified field and try again.

 

Error Code

WS30016

Text

Validation problem, the value for <field name>, is not a valid StatusMapping

Details

The value you have entered for the specified field is not a valid certificate reason (StatusMapping).

Solution

Check the value you have entered and try again.

 

Error Code

WS30017

Text

Validation problem, the value for 'First Name', and 'Last Name' must be provided.

Details

You have attempted to save a person's record with neither a first name nor a last name. You must include one or both of these values.

Solution

Ensure that you have specified one or both of the First Name and Last Name fields, then attempt to save the person's record again.

 

Error Code

WS30018

Text

Validation problem, the value for <field name>, is not an allowed value

Details

The value you have entered for the specified field is not permitted.

Solution

Check the value you have entered and try again.

 

Error Code

WS30019

Text

Validation problem, the value for <field name>, is not correctly encoded binary data

Details

You have attempted to submit a file (for example, an image file) but the binary data file is not encoded correctly.

Solution

Check the file you are submitting and try again.

 

Error Code

WS30020

Text

The value provided contains one or more characters which are disallowed.

Details

The provided password is not valid.

Solution

Provide a password that contains allowed characters and try again.

 

Error Code

WS30021

Text

Biometric samples of the required type cannot be found for the user.

Details

Adjudication requires fingerprint samples captured using a 10-Slap enrollment device. Check that you have captured new fingerprints before submitting for adjudication.

Solution

See the Adjudication Integration Guide provided with the Adjudication module and the Aware Fingerprint Capture guide provided with the Aware Fingerprint Capture module for details.

 

Error Code

WS30022

Text

must be a date in the future

Details

The field failed validation as the provided value can only be a date in the future.

Solution

Provide a date in the future and try again.

 

Error Code

WS30023

Text

must be a date in the past

Details

The field failed validation as the provided value can only be a date in the past.

Solution

Provide a date in the past and try again.

 

Error Code

WS40000

Text

Validation problem, the value for 'Distinguished Name', already exists

Details

You have specified a Distinguished Name for the person that is already used for a different person, and your system is configured to require unique DNs.

Solution

Enter a unique DN for the person and try again. Alternatively, you can configure your system to allow duplicate DNs; the Allow duplicate DN configuration option determines whether unique DN values are required; see the LDAP page (Operation Settings) section in the Administration Guide for details.

 

Error Code

WS40001

Text

Validation problem, the value for ‘Logon’, already exists

Details

You have specified a Logon name for the person that is already used for another person. Logon names must be unique.

Solution

Enter a unique logon name and try again.

 

Error Code

WS40002

Text

The specified Credential Profile could not be found

Details

The credential profile you selected is no longer available.

Solution

Select a different credential profile and try again.

 

Error Code

WS40003

Text

Duplicate group name is not allowed (a group with this name already exists for this parent)

Details

You have specified a group name that already exists. Groups that are located under the same parent group must have unique names.

Solution

Enter a new group name and try again.

 

Error Code

WS40004

Text

Unable to get default roles for group

Details

When adding a person, default roles are retrieved from that person's group – this operation has failed.

Solution

Retry the operation. Make sure that the group you have selected is valid.

 

Error Code

WS40005

Text

The item referenced was not found

Details

You have selected an item (for example, a person, device, or request) that does not exist, has been removed by another operator, or over which you do not have permission.

Solution

Retry the operation. If the problem persists, check that you have sufficient privilege to access the item.

Check the MyID System Events workflow and the rest.core logs for more information. For information on configuring logging, see the MyID REST and authentication web services section in the Configuring Logging guide.

 

Error Code

WS40006

Text

The required group, <group name>, is not available

Details

You have specified a group that is not available.

Solution

Check the group name and try again.

 

Error Code

WS40007

Text

The user location in the directory could not be matched to an existing group

Details

When importing a person to the MyID database from a directory, the person could not be matched to a group in MyID.

Solution

Try one of the following:

  • Manually pick a MyID group for the user to be imported into and save the record again.
  • Use the Edit Groups workflow in MyID Desktop and import the LDAP groups into MyID.

    See the Importing an LDAP directory branch section in the Operator's Guide for details.

  • If you want groups to be automatically imported from LDAP, set the Automatically create MyID groups from the Organizational Unit of imported users configuration option on the LDAP page of the Operation Settings workflow.

 

Error Code

WS40008

Text

Directory synchronization is not available with this API due to configuration or role limitations

Details

An attempt has been made to synchronize a person with the directory manually; however, this operation is disabled due to system configuration.

Directory synchronization is controlled by the following configuration:

  • If the Background Update configuration option is turned on, people are automatically updated in the MyID database when they are retrieved. In this situation it does not make sense to synchronize the person from LDAP manually. An attempt to trigger a manual synchronization would produce this error; however, the button does not appear.
  • If the Background Update configuration option is turned off, if the caller has roles to enable manual directory sync, the operator can request a directory synchronization by clicking the button. In this situation, this error code will not occur.

Solution

As the button appears only when it is allowed by system configuration, this error is unlikely to appear. However, if it does appear, it means that a client is out of step with the server configuration. Shut down the client, clear the browser cache, and try the operation again.

 

Error Code

WS40009

Text

You must provide a reason for rejecting the specified request.

Details

You have attempted to reject a request without specifying a reason. A reason is mandatory when rejecting a request.

Solution

Specify a reason for rejecting the request and try again.

 

Error Code

WS40010

Text

You must provide a reason for canceling the specified request.

Details

You have attempted to cancel a request without specifying a reason. A reason is mandatory when canceling a request.

Solution

Specify a reason for canceling the request and try again.

 

Error Code

WS40011

Text

When creating or approving a request, the job expiry date must be in the future. Either the newly selected request maximum expiry date, or the user maximum expiry date of the request target is in the past.

Details

Either the selected maximum expiry date for the request, or the user maximum expiry date is in the past.

Solution

Specify a date for the request that is in the future and try again.

 

Error Code

WS40012

Text

The device cannot be replaced because it is not issued

Details

You have specified a device to be replaced, but MyID does not recognize it as an issued device.

Solution

Specify a valid issued device and try again.

 

Error Code

WS40013

Text

The device cannot be replaced because it is has already expired

Details

You have specified a device to be replaced, but it has already expired.

Solution

Specify a currently-issued device to be replaced, or request a new device to replace the original expired device.

 

Error Code

WS40014

Text

The device cannot be replaced because it is too close to its expiry date

Details

You have attempted to replace a device, but it will expire soon. You must renew the device instead.

By default, the renewal window is 42 days; this is configured by the Card Renewal Period option on the Devices page of the Operation Settings workflow. You can renew a card if its expiry date is within this window.

Solution

Renew the device.

 

Error Code

WS40015

Text

The device cannot be replaced because it does not have a credential profile

Details

You have attempted to replace a device, but the credential profile used to issue the device has been removed.

Solution

Cancel the device and issue a new one.

 

Error Code

WS40016

Text

The device cannot be renewed because its remaining lifetime does not fall within the configured window for renewals

Details

By default, the renewal window is 42 days; this is configured by the Card Renewal Period option on the Devices page of the Operation Settings workflow. You can renew a card if its expiry date is within this window.

Solution

Wait for the device to fall within the window for renewals before trying again.

 

Error Code

WS50000

Text

Your current authentication level cannot access this information. The logon credential used, roles that logon credential can access and scope available to those roles may limit your access

Details

You do not have permission to perform the requested operation.

Solution

Check the roles and scope for the operator who is attempting to carry out this operation. It is possible to have different scopes for different operations; for example, you may be allowed to view all people in the system, but only be allowed to edit people from a particular group.

Check the MyID System Events and Audit Reporting workflows for more information about the operation being attempted.

 

Error Code

WS50001

Text

Licence Limit Reached

Details

You have attempted to add a person or request a device but have reached the maximum number of people or devices.

Solution

Either remove some people or devices that are no longer required, or request extra licenses from Intercede. See the Requesting licenses section in the Administration Guide for details.

 

Error Code

WS50002

Text

You do not have permission to update your own device

Details

The system is configured using the Self-service option (on the Self-Service page of the Security Settings workflow) to prevent you from performing updates to devices that belong to you; for example, you are not allowed to enable a disabled device that belongs to you.

Solution

Ask another operator to update the device for you.

 

Error Code

WS50003

Text

You do not have permission to update the device you authenticated with

Details

You have attempted to perform an update on the device that you logged on with. This is not allowed.

Solution

Ask another operator to update the device for you.

 

Error Code

WS50004

Text

The system is not configured to allow you to edit your own information

Details

The system is configured to prevent you from updating your own details.

Solution

Ask another operator to edit your information.

 

Error Code

WS50005

Text

Searching for people in the database is disabled

Details

You have attempted to search for a person in the MyID database, but MyID is not configured to do so.

Solution

You can search the MyID database only if you have configured MyID to do so; you must set the Search a directory configuration option to No or Ask. See the LDAP page (Operation Settings) section in the Administration Guide for details.

 

Error Code

WS50006

Text

Searching for people in the directory is disabled

Details

You have attempted to search for a person in an attached directory, but MyID is not configured to do so.

Solution

You can search a directory only if you have configured MyID to do so; you must set the Search a directory configuration option to Yes or Ask. See the LDAP page (Operation Settings) section in the Administration Guide for details.

 

Error Code

WS50007

Text

Invalid job status change

Details

You have attempted to update a request job to a status that is not permitted.

Solution

The MyID Operator Client prevents you from making changes that are not permitted; however, it is possible that another operator has made a change to the status of the request job at the same time.

Retry the operation; if the problem persists, close the Operator Client, clear the browser cache, and try again. If the problem persists further, check the MyID System Events and Audit Reporting workflows.

 

Error Code

WS50008

Text

Your assigned roles do not have permission to request the credential profile specified

Details

You have specified a credential profile to which you do not have access.

Solution

The credential profiles available depend on the role of the operator and the role of the person for whom you are requesting the device; see the details of the Can Request option in the Constrain credential profile issuer section in the Administration Guide.

 

Error Code

WS50009

Text

It is not possible to create requests for yourself or your devices.

Details

This message occurs when an attempt is made by an operator to request their own credentials. It could occur when:

  • Attempting to request a replacement for one of their devices.

  • Attempting to request a renewal for one of their devices.

  • Attempting to request a device for themselves (Note: The button for this is not available in MyID Operator Client).

Solution

Ask another operator to carry out the operation.

 

Error Code

WS50010

Text

Your assigned roles do not have permission to approve or reject requests for this credential profile

Details

You have attempted to approve or reject a request that uses a credential profile that you are not allowed to validate.

Solution

The credential profiles you can validate depend on your role; see the details of the Can Validate option in the Constrain credential profile validator section in the Administration Guide.

 

Error Code

WS50011

Text

The person selected does not have a role assigned that can hold the requested credential profile

Details

You have attempted to request a device using a credential profile to which the person does not have access.

Solution

The credential profiles available depend on the role of the operator and the role of the person for whom you are requesting the device; see the details of the Can Receive option in the Linking credential profiles to roles section in the Administration Guide.

 

Error Code

WS50012

Text

The person selected does not have user data approved. The credential profile requires user data to be approved before it can be requested

Details

You have attempted to request a device using a credential profile that requires the person to have the User Data Approved flag set on their account, but the person does not have this flag set.

Solution

Either set the User Data Approved flag, or edit the credential profile so that it does not require this flag; see the details of the Require user data to be approved option in the Issuance Settings section in the Administration Guide.

 

Error Code

WS50013

Text

The account selected is not compatible with this request (kind is mismatched)

Details

Requests cannot be made for the selected person. This could be due to this account being a special kind of record that represents a non-person entity (for example, for device identities).

Solution

If you are trying to request a credential for a non-person, such as a device identity, use MyID Desktop instead; the MyID Operator Client does not currently support requests of this kind.

If you continue to have problems, check the configuration of the credential profile you are using. You can also check the MyID System Events and Audit Reporting workflows.

 

Error Code

WS50014

Text

You are not permitted to approve or reject requests that you have made

Details

You have attempted to approve or reject a request that you initiated. You cannot validate these requests.

Solution

Ask another operator to validate the request.

 

Error Code

WS50015

Text

You are not permitted to approve or reject requests that you will receive

Details

You have attempted to approve or reject a request for your own device. You cannot validate these requests.

Solution

Ask another operator to validate the request.

 

Error Code

WS50016

Text

The person selected does not have all required information for this credential profile. Check the Person History audit details to identify the missing requisite user data.

Details

You have specified a credential profile that has specific requisite user data requirements; the person you have specified does not meet those requirements.

Solution

Select a different credential profile, or update the person's user account to provide the requisite user data.

See the Requisite User Data section in the Administration Guide for details.

 

Error Code

WS50017

Text

The person selected does not have a Distinguished Name. This profile requires a Distinguished Name for credential issuance.

Details

You have specified a credential profile that requires a Distinguished Name for issuing its certificates.

Solution

Update the person's user account to provide a Distinguished Name.

 

Error Code

WS50018

Text

This credential profile can only be requested using a Derived Credential process

Details

You have specified a credential profile that is used for Derived Credentials.

Solution

Specify a different credential profile, or request the device using the appropriate process for derived credentials; for example, see the Requesting a Derived Credential section in the Derived Credentials Self-Service Request Portal guide.

 

Error Code

WS50019

Text

Requests created using this API must include Smart Card, Virtual Smart Card, Windows Hello for Business or FIDO encoding types

Details

The MyID Operator Client is currently restricted to using credential profiles that are designed for smart cards, VSCs, Windows Hello for Business, or FIDO.

Windows Hello for Business and FIDO are not supported in MyID Professional.

Solution

Check the credential profile you are trying to use. Either select a credential profile that is supported by the MyID Operator Client, or, if you need to use a credential profile that is not supported, use MyID Desktop instead.

 

Error Code

WS50020

Text

A requested role has been excluded through the application of group role restrictions

Details

You have requested a role for a person that is not available because the person's group does not allow this role.

Solution

Either select a different role or amend the group so that it has access to the required role. See the Changing a group section in the Operator's Guide for details.

 

Error Code

WS50021

Text

The scope requested for a role is greater than the maximum scope assignable by the current operator

Details

You have requested a scope level that is higher than your own scope. An operator cannot assign a scope higher than their own level.

Solution

Request a lower scope level that is at your own level or lower.

 

Error Code

WS50022

Text

A requested role is manager controlled and the operator does not hold the role that would permit them to assign it

Details

You have requested a role that is restricted by the Managed By option.

Solution

Either select a different role, or update the Managed By option for the required role to contain one of your own roles; this will allow you to assign the role.

See the Controlling the assigning of roles section in the Administration Guide.

 

Error Code

WS50023

Text

This type of request is not allowed to be updated

Details

You have attempted to update a request that is not allowed to be updated.

Solution

Retry the operation. Further information is available in the MyID System Events and Audit Reporting workflows.

 

Error Code

WS50024

Text

Enabling/Disabling a directory person is not allowed

Details

You have attempted to enable or disable a person whose details are stored in a directory. You can enable or disable user accounts for people only if they are stored in the MyID database.

Solution

Select a person in the MyID database and try again.

 

Error Code

WS50025

Text

You do not have permissions to edit PIV applicants

Details

You have attempted to edit a PIV applicant; this is not possible as you do not have permission to use the Edit PIV Applicant feature.

Solution

Check the role and permission assignments of the operator.

 

Error Code

WS50026

Text

You do not have permission to add or remove the specified administrator groups

Details

You have attempted to add or remove administration groups but you do not have permission to those groups.

Solution

Request permission from an administrator; see the Administrative groups section in the Administration Guide for details.

 

Error Code

WS50027

Text

The operator does not have sufficient scope to create a request for this account

Details

You have attempted to create a request for a person, but that person does not sit within your scope.

Solution

Check your scope; see the Scope and security section in the Administration Guide for details.

 

Error Code

WS50028

Text

You cannot validate or reject a request which does not have an Awaiting Validation status

Details

You have attempted to validate or reject a request, but the request is not awaiting validation, so does not need to be validated or rejected.

Solution

Check the status of the request.

 

Error Code

WS50029

Text

You cannot cancel a request which has a Completed, Canceled or Failed status

Details

You have attempted to cancel a request, but the request's status is Completed, Canceled or Failed; requests at those statuses do not need to be canceled.

Solution

Check the status of the request.

 

Error Code

WS50030

Text

The person selected does not have a photo. The credential profile requires the user to have a photo before it can be requested

Details

The Enforce Photo at Issuance option in the credential profile is set to Request and Issuance, which means that you cannot request or issue a card if the cardholder does not have a photo.

Solution

Capture a photo for the person and try again.

Alternatively, edit the credential profile to set the Enforce Photo at Issuance option to No.

 

Error Code

WS50031

Text

Operation ID <operation> is not a permitted clone of operation <operation>

Details

An API call has been made which violates the cloned operation configuration.

Solution

If this occurs when using the MyID Operator Client, contact customer support.

If this occurs when calling the REST API directly, check the op parameter references an allowed cloned operation.

 

Error Code

WS50032

Text

The conditions on the Operation with ID <operation ID> prohibit use of the operation for the target entity

Details

An operation has been attempted that is not permitted for the entity that would be affected by the operation.

Solution

If this occurs when using the MyID Operator Client, contact customer support.

If calling the API directly, make sure the operation that is being used is permitted for the entity that would be affected by the operation. For example, this error will occur when using the Edit Person operation to attempt to edit a person who holds the PIV Applicant role.

 

Error Code

WS50033

Text

The person selected does not have fingerprint biometrics. The credential profile requires that the recipient has fingerprint biometrics enrolled.

Details

You have attempted to request a device for a person who does not have fingerprints stored in the MyID database, the credential profile for the device has the Require Fingerprints at Issuance option set, and the Enforce biometrics at request configuration option (on the Biometrics page of the Operation Settings workflow) is set.

Solution

Enroll fingerprints for the person, select a different credential profile that does not have the Require Fingerprints at Issuance option set, or set the Enforce biometrics at request configuration option to No.

 

Error Code

WS50034

Text

The person selected does not have facial biometrics. The credential profile requires that the recipient has facial biometrics enrolled.

Details

You have attempted to request a device for a person who does not have fingerprints stored in the MyID database, the credential profile for the device has the Require Facial Biometrics option set, and the Enforce biometrics at request configuration option (on the Biometrics page of the Operation Settings workflow) is set.

Solution

Enroll facial biometrics for the person, select a different credential profile that does not have the Require Facial Biometrics option set, or set the Enforce biometrics at request configuration option to No.

 

Error Code

WS50035

Text

An existing request has been found that prevents this action. Check requests that are already created and if necessary cancel them.

Details

You have attempted to request a device for a person using a credential profile that has the Block Multiple Requests for Credential Group set, and the person already has an existing request for a device from the same credential group.

Solution

Request a device from a different credential profile that is not subject to the same credential group restrictions, or cancel the existing request, if necessary.

See the Block Multiple Requests for Credential Group section in the Administration Guide.

 

Error Code

WS50036

Text

The person selected has a maximum credential expiry date that is before the date requested.

Details

You have requested an expiry date for a device that is after the person's maximum credential expiry date.

Solution

Choose an expiry date for the device that is before the person's maximum credential expiry date, and try again.

See the Editing a PIV applicant and Requesting a device for a person sections in the MyID Operator Client guide for details.

 

Error Code

WS50037

Text

Creating a request is not allowed. <details>

Details

You have attempted to create a request, but it does not meet the criteria set by a customized system. The <details> may provide more information.

Solution

Check the requirements of the customized system, adjust the request to meet those requirements, then try again.

 

Error Code

WS50038

Text

The selected credential profile is not allowed because the person that requested the job was not allowed to request this credential profile.

Details

The system has checked the permissions on the job (for example, the device request) and the issuer does not have the required permissions to request the credential profile selected.

Solution

Select a different credential profile, or cancel the request and create a new device request.

 

Error Code

WS50039

Text

You cannot action your own adjudications.

Details

The operator has attempted to generate or update an adjudication request for themselves.

Solution

Ask another operator to carry out the adjudication.

 

Error Code

WS50040

Text

You do not have permission to perform this operation against the selected item.

Details

You have attempted to perform an action on an item, but your scope does not permit the action. For example, if you have scope that allows you to view a user, and permission to validate requests, but your validate request scope does not allow you to validate requests for that user, you can attempt to validate a request for the user, but the action will not succeed, and this error appears.

Solution

Make sure that your scope permits you to carry out the appropriate actions for the target user, then try again.

 

Error Code

WS50041

Text

This action cannot be performed because the user has outstanding adjudications.

Details

A person can only have one adjudication that is being processed at once. This error appears when an adjudication request is attempted for a person who has an outstanding unfinished request.

Solution

Complete or cancel the existing adjudication.

 

Error Code

WS50042

Text

The request task type is not supported by the credential profile.

Details

The system can restrict certain credential profiles being used for certain types of jobs. For example, you cannot issue a VSC to a FIDO authenticator.

Solution

Select the correct device type for the credential profile.

 

Error Code

WS50043

Text

This credential profile can only be requested from Request Device.

Details

Request Card has been used for to generate a request for a FIDO device. There is a different workflow used to request FIDO device jobs.

Solution

Use the correct process for requesting FIDO authenticators.

 

Error Code

WS50044

Text

This device requires secondary authorization to cancel it. Please use the MyID Desktop Cancel Credentials workflow.

Details

You have attempted to cancel a device that was issued with a credential profile that had the Validate Cancellation option selected. Validating cancellations is not supported in the MyID Operator Client.

Solution

Use the Cancel Credential workflow in MyID Desktop to cancel the device.

 

Error Code

WS50045

Text

The device selected cannot be canceled. Please refer to product documentation for further guidance.

Details

You have attempted to cancel a server credential. You cannot cancel server credentials.

Solution

Choose a different device and try again.